<html>
<!--
 Copyright (C) 2005, 2006 Joe Walnes.
 Copyright (C) 2006, 2007, 2008, 2009, 2011, 2013, 2014, 2015, 2016, 2017, 2019 XStream committers.
 All rights reserved.
 
 The software in this package is published under the terms of the BSD
 style license a copy of which has been included with this distribution in
 the LICENSE.txt file.
 
 Created on 29. January 2005 by Joe Walnes
 -->
    <head>
        <title>Converters</title>
        <style type="text/css">
            .example { font-family: courier; font-size: 8pt; }
            #content td {     border-top: thin solid #5c5 ;}
            #content .headerRow { background-color: white; }
        </style>
    </head>
    <body>

        <p>The core of XStream consists of a registry of
        <a href="javadoc/com/thoughtworks/xstream/converters/Converter.html"><b>Converters</b></a>. The responsibility
        of a Converter is to provide a strategy for converting particular types of objects found in the object graph,
        to and from XML.</p>

        <p>XStream is provided with Converters for common types such as primitives, String, File, Collections, arrays,
        and Dates.  The following table lists any converter delivered with XStream and documents, if they are
        registered by default with which priority.</p>

		
        <table class="examplesTable" summary="Overview over all Converters delivered with XStream">
            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.lang">java.lang (and core special types)</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/NullConverter.html">NullConverter</a></td>
                <td>null values</td>
                <td class="example">&lt;null/&gt;</td>
                <td>Usually, null fields are left out of the XML, however when used in arrays or the root object they
                have to be explicitly marked.</td>
                <td>very high</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/ArrayConverter.html">ArrayConverter</a></td>
                <td>any kind of array</td>
                <td class="example">
                    &lt;<i>string</i>-array&gt;<br/>
                    &nbsp;&nbsp;&lt;<i>string</i>&gt;apple&lt;/<i>string</i>&gt;<br/>
                    &nbsp;&nbsp;&lt;<i>string</i>&gt;banana&lt;/<i>string</i>&gt;<br/>
                    &nbsp;&nbsp;&lt;<i>string</i>&gt;cabbage&lt;/<i>string</i>&gt;<br/>
                    &lt;<i>string</i>-array&gt;
                </td>
                <td>This supports arrays of primitives as well as objects. It also supports multi-dimensional arrays, even if
                they are non-rectangular.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/BooleanConverter.html">BooleanConverter</a></td>
                <td>boolean<br/>java.lang.Boolean</td>
                <td class="example">&lt;boolean&gt;true&lt;/boolean&gt;</td>
                <td>Can also be registered locally using different values.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/ByteConverter.html">ByteConverter</a></td>
                <td>byte<br/>java.lang.Byte</td>
                <td class="example">&lt;byte&gt;22&lt;/byte&gt;</td>
                <td>The byte is represented as an integer.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/EncodedByteArrayConverter.html">EncodedByteArrayConverter</a></td>
                <td>byte[]</td>
                <td class="example">&lt;byte-array&gt;AHiEFiEABQ==&lt;/byte-array&gt;</td>
                <td>Uses Base64 encoding to store binary data in XML. Converter can be registered globally or locally.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/CharConverter.html">CharConverter</a></td>
                <td>char<br/>java.lang.Character</td>
                <td class="example">&lt;char&gt;X&lt;/char&gt;<br/>&lt;char null=&quot;true&quot;/&gt;</td>
                <td>The '\0' character is invalid in XML.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/CharArrayConverter.html">CharArrayConverter</a></td>
                <td>char[]</td>
                <td class="example">&lt;char-array&gt;hello&lt;char-array&gt;</td>
                <td>Joins all characters into a single String.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/DoubleConverter.html">DoubleConverter</a></td>
                <td>double<br/>java.lang.Double</td>
                <td class="example">&lt;double&gt;456774543443.4553435&lt;/double&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/FloatConverter.html">FloatConverter</a></td>
                <td>float<br/>java.lang.Float</td>
                <td class="example">&lt;float&gt;4563443.435&lt;/float&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/IntConverter.html">IntConverter</a></td>
                <td>int<br/>java.lang.Integer</td>
                <td class="example">&lt;int&gt;12345678&lt;/int&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/LongConverter.html">LongConverter</a></td>
                <td>long<br/>java.lang.Long</td>
                <td class="example">&lt;long&gt;2344556678888786&lt;/long&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/NamedArrayConverter.html">NamedArrayConverter</a></td>
                <td>any kind of array</td>
                <td class="example">
                    &lt;<i>string</i>-array&gt;<br/>
                    &nbsp;&nbsp;&lt;<i>product</i>&gt;apple&lt;/<i>product</i>&gt;<br/>
                    &nbsp;&nbsp;&lt;<i>product</i>&gt;banana&lt;/<i>product</i>&gt;<br/>
                    &nbsp;&nbsp;&lt;<i>product</i>&gt;cabbage&lt;/<i>product</i>&gt;<br/>
                    &lt;<i>string</i>-array&gt;
                </td>
                <td>This supports arrays of primitives as well as objects. It also supports multi-dimensional arrays, even if
                they are non-rectangular.  Should be registered locally or for an individual array type.</td>
                <td>&nbsp;</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/ShortConverter.html">ShortConverter</a></td>
                <td>short<br/>java.lang.Short</td>
                <td class="example">&lt;short&gt;1445&lt;/short&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/StringConverter.html">StringConverter</a></td>
                <td>java.lang.String</td>
                <td class="example">&lt;string&gt;hello world&lt;/string&gt;</td>
                <td>This converter can be registered with different caching strategies.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/StringBufferConverter.html">StringBufferConverter</a></td>
                <td>java.lang.StringBuffer</td>
                <td class="example">&lt;string-buffer&gt;hello world&lt;/string-buffer&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/StringBuildererConverter.html">StringBuilderConverter</a></td>
                <td>java.lang.StringBuilder</td>
                <td class="example">&lt;string-builder&gt;hello world&lt;/string-builder&gt;</td>
                <td>Available with Java 1.5 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ThrowableConverter.html">ThrowableConverter</a></td>
                <td>java.lang.Throwable<br/>java.lang.Exception<br/>java.lang.RuntimeException<br/>java.lang.Error<br/>...and all subclasses
                of these.</td>
                <td class="example">
                    &lt;java.io.IOException&nbsp;serialization=&quot;custom&quot;&gt;<br/>
                    &nbsp;&lt;java.lang.Throwable&gt;<br/>
                    &nbsp;&nbsp;&lt;default&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&lt;detailMessage&gt;No file&lt;/detailMessage&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&lt;stack-trace&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;trace&gt;com.x.Foo.stuff(Foo.java:22)&lt;/trace&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;trace&gt;com.x.Foo.blah(Foo.java:31)&lt;/trace&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;trace&gt;com.x.Foo.main(Foo.java:43)&lt;/trace&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&lt;/stack-trace&gt;<br/>
                    &nbsp;&nbsp;&lt;/default&gt;<br/>
                    &nbsp;&lt;/java.lang.Throwable&gt;<br/>
                    &lt;/java.io.IOException&gt;
                </td>
                <td>This is only available with Java 1.4 or greater. It retains the full stack trace, including that of any
                nested exceptions. The stack trace elements are handled by the
                <a href="javadoc/com/thoughtworks/xstream/converters/extended/StackTraceElementConverter.html">StackTraceElementConverter</a>.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/enums/EnumConverter.html">EnumConverter</a></td>
                <td>java.lang.Enum</td>
                <td class="example">&lt;java.lang.annotation.RetentionPolicy&gt;<br/>CLASS<br/>&lt;/java.lang.annotation.RetentionPolicy&gt;</td>
                <td>Available with Java 1.5 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/enums/EnumToStringConverter.html">EnumToStringConverter</a></td>
                <td>java.lang.Enum</td>
                <td>The Converter must be initialized with an Enum type and an optional mapping between strings and enum values. By default
                it will use the Enum's string representation as value.</td>
                <td>Available with Java 1.5 or greater. Must be registered explicitly for the Enum type or locally.</td>
                <td>&nbsp;</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.util">java.util</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/CollectionConverter.html">CollectionConverter</a></td>
                <td>java.util.ArrayList<br/>java.util.LinkedList<br/>java.util.HashSet<br/>java.util.Vector<br/>java.util.LinkedHashSet</td>
                <td class="example">
                    &lt;linked-list&gt;<br/>
                    &nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&lt;string&gt;banana&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&lt;big-decimal&gt;12345.4555&lt;/big-decimal&gt;<br/>
                    &lt;/linked-list&gt;
                </td>
                <td>The objects inside the collection can be any type of objects, including nested collections.  Can be
                registered for an individual Collection type or locally, suppression of implicit type might be
                necessary.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/MapConverter.html">MapConverter</a></td>
                <td>java.util.HashMap<br/>java.util.Hashtable<br/>java.util.LinkedHashMap<br/>java.util.concurrent.ConcurrentHashMap</td>
                <td class="example">
                    &lt;map&gt;<br/>
                    &nbsp;&nbsp;&lt;entry&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;float&gt;123.553&lt;/float&gt;<br/>
                    &nbsp;&nbsp;&lt;/entry&gt;<br/>
                    &nbsp;&nbsp;&lt;entry&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;orange&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;float&gt;55.4&lt;/float&gt;<br/>
                    &nbsp;&nbsp;&lt;/entry&gt;<br/>
                    &lt;/map&gt;
                </td>
                <td>Both key and values can be any type of objects.  Can be registered for an individual Map type or
                locally, suppression of implicit type might be necessary.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/NamedCollectionConverter.html">NamedCollectionConverter</a></td>
                <td>java.util.ArrayList<br/>java.util.LinkedList<br/>java.util.HashSet<br/>java.util.Vector<br/>java.util.LinkedHashSet</td>
                <td class="example">
                    &lt;fruits&gt;<br/>
                    &nbsp;&nbsp;&lt;fruit&gt;apple&lt;/fruit&gt;<br/>
                    &nbsp;&nbsp;&lt;fruit&gt;banana&lt;/fruit&gt;<br/>
                    &nbsp;&nbsp;&lt;fruit&gt;orange&lt;/fruit&gt;<br/>
                    &lt;/fruits&gt;
                </td>
                <td>The objects inside the collection can be of any type shared between the objects.  Should be
                registered locally or for an individual Collection type.</td>
                <td>&nbsp;</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/NamedMapConverter.html">NamedMapConverter</a></td>
                <td>java.util.HashMap<br/>java.util.Hashtable<br/>java.util.LinkedHashMap<br/>java.util.concurrent.ConcurrentHashMap</td>
                <td class="example">
                    &lt;map&gt;<br/>
                    &nbsp;&nbsp;&lt;fruit&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;name&gt;apple&lt;/name&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;price&gt;123.553&lt;/price&gt;<br/>
                    &nbsp;&nbsp;&lt;/fruit&gt;<br/>
                    &nbsp;&nbsp;&lt;fruit&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;name&gt;orange&lt;/name&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;price&gt;55.4&lt;/price&gt;<br/>
                    &nbsp;&nbsp;&lt;/fruit&gt;<br/>
                    &lt;/map&gt;
                </td>
                <td>Both key and values can be any type of objects.  If key or value are written as attributes or if
                the value is written as text of the entry element, those types must be handled by a
                <a href="javadoc/com/thoughtworks/xstream/converters/SingleValueConverter.html">SingleValueConverter</a>.
                Should be registered locally or for an individual Map type.</td>
                <td>&nbsp;</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/PropertiesConverter.html">PropertiesConverter</a></td>
                <td>java.util.Properties</td>
                <td class="example">
                    &lt;properties&gt;<br/>
                    &nbsp;&nbsp;&lt;property name=&quot;host&quot; value=&quot;localhost&quot;/&gt;<br/>
                    &nbsp;&nbsp;&lt;property name=&quot;port&quot; value=&quot;888&quot;/&gt;<br/>
                    &lt;/properties&gt;
                </td>
                <td>Because the Properties class only accepts Strings for keys and values, the XML can be more concise. 
                If the Properties instance includes a set of default Properties, these are serialized in a nested <code>&lt;defaults&gt;</code> element.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/SingletonCollectionConverter.html">SingletonCollectionConverter</a></td>
                <td>java.util.Collections.singletonList().getClass()<br/>java.util.Collections.singleton().getClass()</td>
                <td class="example">
                    &lt;singleton-set&gt;<br/>
                    &nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
                    &lt;/singleton-set&gt;
                </td>
                <td>The objects inside the singleton collection can be any type of objects, including nested collections.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/SingletonMapConverter.html">SingletonMapConverter</a></td>
                <td>java.util.Collections.singletonMap().getClass()</td>
                <td class="example">
                    &lt;singleton-map&gt;<br/>
                    &nbsp;&nbsp;&lt;entry&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;float&gt;123.553&lt;/float&gt;<br/>
                    &nbsp;&nbsp;&lt;/entry&gt;<br/>
                    &lt;/singleton-map&gt;
                </td>
                <td>The objects inside the singleton collection can be any type of objects, including nested collections.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/TreeMapConverter.html">TreeMapConverter</a></td>
                <td>java.util.TreeMap</td>
                <td class="example">
                    &lt;tree-map&gt;<br/>
                    &nbsp;&nbsp;&lt;comparator class=&quot;com.blah.MyComparator&quot;/&gt;<br/>
                    &nbsp;&nbsp;&lt;entry&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;float&gt;123.553&lt;/float&gt;<br/>
                    &nbsp;&nbsp;&lt;/entry&gt;<br/>
                    &nbsp;&nbsp;&lt;entry&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;orange&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;float&gt;55.4&lt;/float&gt;<br/>
                    &nbsp;&nbsp;&lt;/entry&gt;<br/>
                    &lt;/tree-map&gt;
                </td>
                <td>This is similar to MapConverter with an additional field for storing the java.util.Comparator associated with the TreeMap.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/TreeSetConverter.html">TreeSetConverter</a></td>
                <td>java.util.TreeSet</td>
                <td class="example">
                    &lt;tree-set&gt;<br/>
                    &nbsp;&nbsp;&lt;comparator class=&quot;com.blah.MyComparator&quot;/&gt;<br/>
                    &nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&lt;string&gt;banana&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&lt;string&gt;cabbage&lt;/string&gt;<br/>
                    &lt;/tree-set&gt;
                </td>
                <td>This is similar to CollectionConverter with an additional field for storing the java.util.Comparator associated with the TreeSet.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/BitSetConverter.html">BitSetConverter</a></td>
                <td>java.util.BitSet</td>
                <td class="example">
                    &lt;bit-set&gt;0,1,3,5,6,8,10&lt;/bit-set&gt;
                </td>
                <td>Stores a comma separated list of which bits are set. Designed to be readable without taking up too much space.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/DateConverter.html">DateConverter</a></td>
                <td>java.util.Date</td>
                <td class="example">&lt;date&gt;2004-02-22 15:16:04.0 UTC&lt;/date&gt;</td>
                <td>Can be registered with different formats, locales or time zone globally or locally.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/GregorianCalendarConverter.html">GregorianCalendarConverter</a></td>
                <td>java.util.Calendar<br/>java.util.GregorianCalendar</td>
                <td class="example">
                    &lt;gregorian-calendar&gt;<br/>
                    &nbsp;&nbsp;&lt;time&gt;555454646&lt;/time&gt;<br/>
                    &lt;/gregorian-calendar&gt;
                </td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ISO8601DateConverter.html">ISO8601DateConverter</a></td>
                <td>java.util.Date</td>
                <td class="example">&lt;date&gt;2006-07-28T12:06:17.654-03:00&lt;/date&gt;</td>
                <td>Not automatically registered, can be used globally or locally. Implementation needs joda-time for JDK 1.7 or below.</td>
                <td>&nbsp;</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ISO8601GregorianCalendarConverter.html">ISO8601GregorianCalendarConverter</a></td>
                <td>java.util.GregorianCalendar</td>
                <td class="example">
                    &lt;gregorian-calendar&gt;<br/>
                    2006-07-28T12:07:02.788-03:00<br/>
                    &lt;/gregorian-calendar&gt;
                </td>
                <td>Not automatically registered, can be used globally or locally. Implementation needs joda-time for JDK 1.7 or below.</td>
                <td>&nbsp;</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/LocaleConverter.html">LocaleConverter</a></td>
                <td>java.util.Locale</td>
                <td class="example">&lt;locale&gt;en_GB&lt;/locale&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/CurrencyConverter.html">CurrencyConverter</a></td>
                <td>java.util.Currency</td>
                <td class="example">&lt;currency&gt;USD&lt;/currency&gt;</td>
                <td>Available with Java 1.4 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/UUIDConverter.html">UUIDConverter</a></td>
                <td>java.util.UUID</td>
                <td class="example">&lt;uuid&gt;ca05f023-e07f-4956-a6ef-14ddd23df47b&lt;/uuid&gt;</td>
                <td>Available with Java 1.5 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/enums/EnumMapConverter.html">EnumMapConverter</a></td>
                <td>java.util.EnumMap</td>
                <td class="example">
                &lt;enum-map enum-type="simple"&gt;<br/>
                &nbsp;&nbsp;&lt;entry&gt;<br/>
                &nbsp;&nbsp;&nbsp;&nbsp;&lt;simple&gt;GREEN&lt;/simple&gt;<br/>
                &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;grass&lt;/string&gt;<br/>
                &nbsp;&nbsp;&lt;/entry&gt;<br/>
                &nbsp;&nbsp;&lt;entry&gt;<br/>
                &nbsp;&nbsp;&nbsp;&nbsp;&lt;simple&gt;BLUE&lt;/simple&gt;<br/>
                &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;sky&lt;/string&gt;<br/>
                &nbsp;&nbsp;&lt;/entry&gt;<br/>
                &lt;/enum-map&gt;</td>
                <td>Available with Java 1.5 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/enums/EnumSetConverter.html">EnumSetConverter</a></td>
                <td>java.util.EnumSet</td>
                <td class="example">
                &lt;enum-set enum-type=&quot;simple&quot;&gt;<br/>
                &nbsp;&nbsp;GREEN,BLUE<br/>
                &lt;/enum-set&gt;</td>
                <td>Available with Java 1.5 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/RegexPatternConverter.html">RegexPatternConverter</a></td>
                <td>java.util.regex.Pattern</td>
                <td class="example">
                &lt;java.util.regex.Pattern&gt;<br/>
				&nbsp;&nbsp;&lt;pattern&gt;.*&lt;/pattern&gt;<br/>
				&nbsp;&nbsp;&lt;flags&gt;0&lt;/flags&gt;<br/>
				&lt;/java.util.regex.Pattern&gt;
                </td>
                <td>Available with Java 1.4 or greater.</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.time">java.time</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/DurationConverter.html">DurationConverter</a></td>
                <td>java.time.Duration</td>
                <td class="example">
                &lt;duration&gt;PT24000H&lt;/duration&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/InstantConverter.html">InstantConverter</a></td>
                <td>java.time.Instant</td>
                <td class="example">
                &lt;instant&gt;2017-07-30T20:40:00Z&lt;/instant&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/LocalDateConverter.html">LocalDateConverter</a></td>
                <td>java.time.LocalDate</td>
                <td class="example">
                &lt;local-date&gt;2017-10-30&lt;/local-date&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/LocalDateTimeConverter.html">LocalDateTimeConverter</a></td>
                <td>java.time.LocalDateTime</td>
                <td class="example">
                &lt;local-date-time&gt;2017-10-30T20:40:15&lt;/local-date-time&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/LocalTimeConverter.html">LocalTimeConverter</a></td>
                <td>java.time.LocalTime</td>
                <td class="example">
                &lt;local-time&gt;20:40:15&lt;/local-time&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/MonthDayConverter.html">MonthDayConverter</a></td>
                <td>java.time.MonthDay</td>
                <td class="example">
                &lt;month-day&gt;--01-13&lt;/month-day&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/OffsetDateTimeConverter.html">OffsetDateTimeConverter</a></td>
                <td>java.time.OffsetDateTime</td>
                <td class="example">
                &lt;offset-date-time&gt;2017-07-30T20:40:00Z&lt;/offset-date-time&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/OffsetTimeConverter.html">OffsetTimeConverter</a></td>
                <td>java.time.OffsetTime</td>
                <td class="example">
                &lt;offset-time&gt;20:40:15+01:00&lt;/offset-time&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/PeriodConverter.html">PeriodConverter</a></td>
                <td>java.time.Period</td>
                <td class="example">
                &lt;period&gt;P1000D&lt;/period&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/SystemClockConverter.html">SystemClockConverter</a></td>
                <td>java.time.Clock$SystemClock</td>
                <td class="example">
                &lt;system-clock&gt;
                &nbsp;&nbsp;&lt;zone&gt;Europe/Berlin&lt;/zone&gt;
                &lt;/system-clock&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/YearConverter.html">YearConverter</a></td>
                <td>java.time.Year</td>
                <td class="example">
                &lt;year&gt;2017&lt;/year&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/YearMonthConverter.html">YearMonthConverter</a></td>
                <td>java.time.YearMonth</td>
                <td class="example">
                &lt;year-month&gt;2017-02&lt;/year-month&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/ZonedDateTimeConverter.html">ZonedDateTimeConverter</a></td>
                <td>java.time.ZonedDateTime</td>
                <td class="example">
                &lt;zoned-date-time&gt;2017-10-30T20:40:00Z[Europe/London]&lt;/zoned-date-time&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/ZoneIdConverter.html">ZoneIdConverter</a></td>
                <td>java.time.ZoneId<br/>java.time.ZoneOffset<br/>java.time.ZoneRegion</td>
                <td class="example">
                &lt;zone-id&gt;Z&lt;/zone-id&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.time.chrono">java.time.chrono</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/ChronologyConverter.html">ChronologyConverter</a></td>
                <td>java.time.chrono.Chronology implementations</td>
                <td class="example">
                &lt;chronology&gt;ISO&lt;/chronology&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/HijrahDateConverter.html">HijrahDateConverter</a></td>
                <td>java.time.chrono.HijrahDate</td>
                <td class="example">
                &lt;hijrah-date&gt;Hijrah-umalqura AH 1438-11-07&lt;/hijrah-date&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/JapaneseDateConverter.html">JapaneseDateConverter</a></td>
                <td>java.time.chrono.JapaneseDate</td>
                <td class="example">
                &lt;japanese-date&gt;Japanese Heisei 29-07-30&lt;/japanese-date&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/JapaneseEraConverter.html">JapaneseEraConverter</a></td>
                <td>java.time.chrono.JapaneseEra</td>
                <td class="example">
                &lt;japanese-era&gt;Taisho&lt;/japanese-era&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/MinguoDateConverter.html">MinguoDateConverter</a></td>
                <td>java.time.chrono.MinguoDate</td>
                <td class="example">
                &lt;minguo-date&gt;Minguo ROC 106-07-30&lt;/minguo-date&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/ThaiBuddhistDateConverter.html">ThaiBuddhistDateConverter</a></td>
                <td>java.time.chrono.ThaiBuddhistDate</td>
                <td class="example">
                &lt;thai-buddhist-date&gt;haiBuddhist BE 2560-07-30&lt;/thai-buddhist-date&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.time.temporal">java.time.temporal</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/ValueRangeConverter.html">ValueRangeConverter</a></td>
                <td>java.time.temporal.ValueRange</td>
                <td class="example">
                &lt;temporal-value-range&gt;<br/>
				&nbsp;&nbsp;&lt;maxLargest&gt;45&lt;/maxLargest&gt;<br/>
				&nbsp;&nbsp;&lt;maxSmallest&gt;30&lt;/maxSmallest&gt;<br/>
				&nbsp;&nbsp;&lt;minLargest&gt;1&lt;/minLargest&gt;<br/>
				&nbsp;&nbsp;&lt;minSmallest&gt;0&lt;/minSmallest&gt;<br/>
				&lt;/temporal-value-range&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/time/WeekFieldsConverter.html">WeekFieldsConverter</a></td>
                <td>java.time.temporal.WeekFields</td>
                <td class="example">
                &lt;week-fields&gt;<br/>
				&nbsp;&nbsp;&lt;minimalDays&gt;2&lt;/minimalDays&gt;<br/>
				&nbsp;&nbsp;&lt;firstDayOfWeek&gt;MONDAY&lt;/firstDayOfWeek&gt;<br/>
				&lt;/week-fields&gt;
                </td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.sql">java.sql</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/SqlDateConverter.html">SqlDateConverter</a></td>
                <td>java.sql.Date</td>
                <td class="example">&lt;sql-date&gt;1978-08-25&lt;/sql-date&gt;</td>
                <td>Only automatically registered if runtime has JDBC support.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/SqlTimeConverter.html">SqlTimeConverter</a></td>
                <td>java.sql.Time</td>
                <td class="example">&lt;sql-time&gt;14:07:33&lt;/sql-time&gt;</td>
                <td>Only automatically registered if runtime has JDBC support.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/SqlTimestampConverter.html">SqlTimestampConverter</a></td>
                <td>java.sql.Timestamp</td>
                <td class="example">&lt;sql-timestamp&gt;1970-01-01 00:00:01.234&lt;/sql-timestamp&gt;</td>
                <td>Only automatically registered if runtime has JDBC support.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ISO8601SqlTimestampConverter.html">ISO8601SqlTimestampConverter</a></td>
                <td>java.sql.Timestamp</td>
                <td class="example">&lt;sql-timestamp&gt;2006-07-28T12:06:17.654000000-03:00&lt;/sql-timestamp&gt;</td>
                <td>Not automatically registered, can be used globally or locally. Implementation needs joda-time for JDK 1.7 or below.</td>
                <td>&nbsp;</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.math">java.math</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/BigDecimalConverter.html">BigDecimalConverter</a></td>
                <td>java.math.BigDecimal</td>
                <td class="example">&lt;big-decimal&gt;342346.445332&lt;/big-decimal&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/BigIntegerConverter.html">BigIntegerConverter</a></td>
                <td>java.math.BigInteger</td>
                <td class="example">&lt;big-int&gt;23434224556&lt;/big-int&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.net">java.net</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/URIConverter.html">URIConverter</a></td>
                <td>java.net.URI</td>
                <td class="example">&lt;uri&gt;mailto:xstream-user.codehaus.org&lt;/uri&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/URLConverter.html">URLConverter</a></td>
                <td>java.net.URL</td>
                <td class="example">&lt;url&gt;http://codehaus.org/blah&lt;/url&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.io">java.io</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/FileConverter.html">FileConverter</a></td>
                <td>java.io.File</td>
                <td class="example">&lt;file&gt;/stuff/hello.txt&lt;/file&gt;</td>
                <td>&nbsp;</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/SerializableConverter.html">SerializableConverter</a></td>
                <td>java.io.Serializable</td>
                <td>&nbsp;</td>
                <td>See description at Generalized Converters.</td>
                <td>low</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/ExternalizableConverter.html">ExternalizableConverter</a></td>
                <td>java.io.Externalizable</td>
                <td class="example">
                    &lt;<i>externalizable-type</i>&gt;<br/>
                    &nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
                    &nbsp;&nbsp;&lt;int&gt;42&lt;/int&gt;<br/>
                    &nbsp;&nbsp;&lt;big-decimal&gt;12345.4555&lt;/big-decimal&gt;<br/>
                    &lt;/<i>externalizable-type</i>&gt;
                </td>
                <td>See description at Generalized Converters.</td>
                <td>low</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.nio">java.nio</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/CharsetConverter.html">CharsetConverter</a></td>
                <td>java.nio.charset.Charset</td>
                <td class="example">&lt;charset&gt;US-ASCII&lt;/charset&gt;</td>
                <td>Available with Java 1.4 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/PathConverter.html">PathConverter</a></td>
                <td>java.nio.file.Path</td>
                <td class="example">&lt;path&gt;../dir/file.txt&lt;/path&gt;</td>
                <td>Available with Java 7 or greater.</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.lang.reflect">java.lang.reflect</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/JavaClassConverter.html">JavaClassConverter</a></td>
                <td>java.lang.Class</td>
                <td class="example">&lt;class&gt;com.foo.MyThing&lt;/class&gt;</td>
                <td>This converter uses the ClassLoaderReference of the XStream instance. Can be registered with
                Mapper globally or locally to respect type aliases.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/JavaFieldConverter.html">JavaFieldConverter</a></td>
                <td>java.lang.reflect.Field</td>
                <td class="example">
                    &lt;field&gt;<br/>
                    &nbsp;&nbsp;&lt;name&gt;myField&lt;/name&gt;<br/>
                    &nbsp;&nbsp;&lt;class&gt;com.foo.MyThing&lt;/class&gt;<br/>
                    &lt;/field&gt;
                </td>
                <td>This converter uses the ClassLoaderReference of the XStream instance. Can be registered with
                Mapper globally or locally to respect type aliases.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/JavaMethodConverter.html">JavaMethodConverter</a></td>
                <td>java.lang.reflect.Method<br/>java.lang.reflect.Constructor</td>
                <td class="example">
                    &lt;method&gt;<br/>
                    &nbsp;&nbsp;&lt;class&gt;com.foo.MyThing&lt;/class&gt;<br/>
                    &nbsp;&nbsp;&lt;name&gt;doStuff&lt;/name&gt;<br/>
                    &nbsp;&nbsp;&lt;parameter-types&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;class&gt;java.lang.String&lt;/class&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;class&gt;java.util.Iterator&lt;/class&gt;<br/>
                    &nbsp;&nbsp;&lt;/parameter-types&gt;<br/>
                    &lt;/method&gt;
                </td>
                <td>The enclosing element for this tag will either by &lt;method&gt; or &lt;constructor&gt;. This converter uses the ClassLoaderReference of the XStream insatance. Can be regisreted with
                Mapper globally or locally to respect type aliases.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/DynamicProxyConverter.html">DynamicProxyConverter</a></td>
                <td>Any dynamic proxy generated by java.lang.reflect.Proxy</td>
                <td class="example">
                    &lt;dynamic-proxy&gt;<br/>
                    &nbsp;&nbsp;&lt;interface&gt;com.foo.Blah&lt;/interface&gt;<br/>
                    &nbsp;&nbsp;&lt;interface&gt;com.foo.Woo&lt;/interface&gt;<br/>
                    &nbsp;&nbsp;&lt;handler class=&quot;com.foo.MyHandler&quot;&gt;<br/>
                    &nbsp;&nbsp;&nbsp;&nbsp;&lt;something&gt;blah&lt;/something&gt;<br/>
                    &nbsp;&nbsp;&lt;/handler&gt;<br/>
                    &lt;/dynamic-proxy&gt;
                </td>
                <td>The dynamic proxy itself is not serialized, however the interfaces it implements and the actual InvocationHandler
                instance are serialized. This allows the proxy to be reconstructed after deserialization.</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.awt">java.awt</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ColorConverter.html">ColorConverter</a></td>
                <td>java.awt.Color</td>
                <td class="example">
                    &lt;awt-color&gt;<br/>
                    &nbsp;&nbsp;&lt;red&gt;255&lt;/red&gt;<br/>
                    &nbsp;&nbsp;&lt;green&gt;255&lt;/green&gt;<br/>
                    &nbsp;&nbsp;&lt;blue&gt;255&lt;/blue&gt;<br/>
                    &nbsp;&nbsp;&lt;alpha&gt;255&lt;/alpha&gt;<br/>
                    &lt;/awt-color&gt;
                </td>
                <td>Only automatically registered if runtime has AWT support.<br/>
                <b>Warning:</b> The AWT toolkit is definitely initialized when a Color is deserialized.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/FontConverter.html">FontConverter</a></td>
                <td>java.awt.Font<br/>
                javax.swing.plaf.FontUIResource</td>
                <td class="example">
                    &lt;awt-font&gt;<br/>
                    &nbsp;&nbsp;&lt;family class=&quot;string&quot;&gt;Arial&lt;/family&gt;<br/>
                    &nbsp;&nbsp;&lt;size class=&quot;float&quot;&gt;20.0&lt;/size&gt;<br/>
                    &nbsp;&nbsp;&lt;width class=&quot;null&quot;/&gt;<br/>
                    &nbsp;&nbsp;&lt;posture class=&quot;null&quot;/&gt;<br/>
                    &nbsp;&nbsp;&lt;weight class=&quot;float&quot;&gt;2.0&lt;/weight&gt;<br/>
                    &nbsp;&nbsp;&lt;superscript class=&quot;null&quot;/&gt;<br/>
                    &lt;/awt-font&gt;
                </td>
                <td>Only automatically registered if runtime has AWT support.<br/>
                <b>Warning:</b> The AWT toolkit is definitely initialized when a Font is deserialized.</td>
                <td>normal</td>
            </tr>
            
            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="java.awt.font">java.awt.font</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/TextAttributeConverter.html">TextAttributeConverter</a></td>
                <td>java.awt.font.TextAttribute</td>
                <td class="example">
                    &lt;awt-text-attribute&gt;family&lt;/awt-text-attribute&gt;
                </td>
                <td>Only automatically registered if runtime has AWT support.<br/>
                <b>Warning:</b> The AWT toolkit is definitely initialized when a TextAttribute is deserialized.</td>
                <td>normal</td>
            </tr>
            
            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="javax.activation">javax.activation</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ActivationDataFlavorConverter.html">ActivationDataFlavorConverter</a></td>
                <td>javax.activation.ActivationDataFlavor</td>
                <td class="example">
                    &lt;activation-data-flavor&gt;<br/>
                    &nbsp;&nbsp;&lt;mimeType&gt;application/x-junit&lt;/mimeType&gt;<br/>
                    &nbsp;&nbsp;&lt;humanRepresentableName&gt;JUnit&lt;/humanRepresentableName&gt;<br/>
                    &nbsp;&nbsp;&lt;representationClass&gt;java.io.InputStream&lt;/representationClass&gt;<br/>
                    &lt;/activation-data-flavor&gt;
                </td>
                <td>Available with Java 6, 7 and 8. Requires module <em>java.activation</em> with Java 9 or greater.<br/>
                <td>normal</td>
            </tr>
            
            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="javax.swing">javax.swing</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/LookAndFeelConverter.html">LookAndFeelConverter</a></td>
                <td>javax.swing.LookAndFeel implementations</td>
                <td class="example">&nbsp;</td>
                <td>Only automatically registered if runtime has Swing support.</td>
                <td>normal</td>
            </tr>
            
            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="javax.security.auth">javax.security.auth</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/SubjectConverter.html">SubjectConverter</a></td>
                <td>javax.security.auth.Subject</td>
                <td class="example">
                &lt;auth-subject&gt;<br/>
				&nbsp;&nbsp;&lt;principals&gt;<br/>
				&nbsp;&nbsp;&nbsp;&nbsp;&lt;com.thoughtworks.xstream.Admin/&gt;<br/>
				&nbsp;&nbsp;&lt;/principals&gt;<br/>
				&nbsp;&nbsp;&lt;readOnly&gt;false&lt;/readOnly&gt;<br/>
				&lt;/auth-subject&gt;<br/>
                </td>
                <td>Available with Java 1.4 or greater. This converter does not serialize any credentials but only the principals.</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="javax.xml.datatype">javax.xml.datatype</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Example</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/DurationConverter.html">DurationConverter</a></td>
                <td>javax.xml.datatype.Duration</td>
                <td class="example">&lt;duration&gt;PT1H2M&lt;/duration&gt;</td>
                <td>Available with Java 1.5 or greater.</td>
                <td>normal</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="generic">Generalized Converters</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Explanation</th>
                <th>Notes</th>
                <th>Prio</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/ReflectionConverter.html">ReflectionConverter</a></td>
                <td>Any type</td>
                <td>The Converter is used as fallback. It uses reflection to examine the class and will serialize its fields.</td>
                <td>&nbsp;</td>
                <td>very low</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/SerializableConverter.html">SerializableConverter</a></td>
                <td>java.io.Serializable or types with one of the serializable methods readObject or writeObject</td>
                <td>The Converter is used for any JDK-serializable types, if not handled by a specialized Converter.</td>
                <td>&nbsp;</td>
                <td>low</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/ExternalizableConverter.html">ExternalizableConverter</a></td>
                <td>java.io.Externalizable</td>
                <td>The Converter is used for any externalizable type, if not handled by a specialized Converter.</td>
                <td>&nbsp;</td>
                <td>low</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/LambdaConverter.html">LambdaConverter</a></td>
                <td>For serializable lambda types.</td>
                <td>Non-serializable lambda instances will be mapped to null, since they contain no information for recreation. Serializable
                lambda types have such info, but it is specific to compiler vendor and occurrence in the code. Never assume that you can
                deserialize such an element when you use a different version of your code or a different compiler.</td>
                <td>Available with Java 8 or greater.</td>
                <td>normal</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ToAttributedValueConverter.html">ToAttributedValueConverter</a></td>
                <td>Any type with all fields to be represented by a single string but one.</td>
                <td>The Converter is used to write all but one fields of the type as attributes. The left over field is then used as current value.</td>
                <td>Must be registered globally or locally for the appropriate type.</td>
                <td>&nbsp;</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ToStringConverter.html">ToStringConverter</a></td>
                <td>Any type with natural String representation</td>
                <td>The Converter must be initialized with a type, that provides a complete String representation with its toString() method
                and is able to be recreated by a constructor taking a single String argument.</td>
                <td>Must be registered globally or locally for the appropriate type.</td>
                <td>&nbsp;</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/javabean/JavaBeanConverter.html">JavaBeanConverter</a></td>
                <td>Java beans</td>
                <td>The Converter handles any type as Java bean. It expects the type to convert to have a public default constructor and
                appropriate getter and setters.</td>
                <td>Must be registered globally or locally. Can be used as fallback with priority <b>very low</b>.</td>
                <td>&nbsp;</td>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/PropertyEditorCapableConverter.html">PropertyEditorCapableConverter</a></td>
                <td>Any type with a PropertyEditor implementation</td>
                <td>The Converter can handles any type that provides a PropertyEditor implementation. The PropertyEditor's methods getAsText() and
                setAsText() are used to convert between object and string representation.</td>
                <td>Must be registered globally or locally for the appropriate type.</td>
                <td>&nbsp;</td>
            </tr>

            <!-- .................................................................................................. -->
            <tr>
                <td colspan="5" class="headerRow"><h1 id="3rdParty">Converters for 3rd party classes</h1></td>
            </tr>
            <tr>
                <th>Converter</th>
                <th>Supported types</th>
                <th>Explanation</th>
                <th>Notes</th>
                <th>Add-On</th>
            </tr>
            <tr>
                <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/CGLIBEnhancedConverter.html">CGLIBEnhancedConverter</a></td>
                <td>Proxies generated by the CGLIB Enhancer</td>
                <td>The Converter handles proxies generated by the CGLIB Enhancer, if there were not multiple callbacks registered.
                A proxy with multiple callbacks can currently not be handled at all.</td>
                <td>Must be registered globally and in combination with the CGLIBMapper. See <a href="faq.html#Serialization_CGLIB">FAQ</a>.</td>
                <td>xstream</td>
            </tr>
            <tr>
                <td><a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/converter/HibernatePersistentCollectionConverter.html">HibernatePersistentCollectionConverter</a></td>
                <td>org.hibernate.collection.internal.PersistentBag<br/>
                org.hibernate.collection.internal.PersistentList<br/>
                org.hibernate.collection.internal.PersistentSet<br/>
                org.hibernate.envers.entities.mapper.relation.lazy.proxy.ListProxy<br/>
                org.hibernate.envers.entities.mapper.relation.lazy.proxy.SetProxy</td>
                <td>The Converter handles Hibernate 4 (or 3) standard collections and Envers proxies. It will handle any element of the collection.</td>
                <td>Must be registered explicitly in combination with the HibernateMapper and all the other Hibernate converters. See <a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/package-summary.html">package description</a>.</td>
                <td>xstream-hibernate</td>
            </tr>
            <tr>
                <td><a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/converter/HibernatePersistentMapConverter.html">HibernatePersistentMapConverter</a></td>
                <td>org.hibernate.collection.internal.PersistentMap<br/>
                org.hibernate.envers.entities.mapper.relation.lazy.proxy.MapProxy</td>
                <td>The Converter handles unsorted Hibernate 4 (or 3) maps or Envers proxy. It will handle any key and value of the map.</td>
                <td>Must be registered explicitly in combination with the HibernateMapper and all the other Hibernate converters. See <a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/package-summary.html">package description</a>.</td>
                <td>xstream-hibernate</td>
            </tr>
            <tr>
                <td><a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/converter/HibernatePersistentSortedMapConverter.html">HibernatePersistentSortedMapConverter</a></td>
                <td>org.hibernate.collection.internal.PersistentSortedMap<br/>
                org.hibernate.envers.entities.mapper.relation.lazy.proxy.SortedMapProxy</td>
                <td>The Converter handles sorted Hibernate 4 (or 3) maps or Envers proxy. It will handle any key and value of the map.</td>
                <td>Must be registered explicitly in combination with the HibernateMapper and all the other Hibernate converters. See <a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/package-summary.html">package description</a>.</td>
                <td>xstream-hibernate</td>
            </tr>
            <tr>
                <td><a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/converter/HibernatePersistentSortedSetConverter.html">HibernatePersistentSortedSetConverter</a></td>
                <td>org.hibernate.collection.intrernal.PersistentSortedSet<br/>
                org.hibernate.envers.entities.mapper.relation.lazy.proxy.SortedSetProxy</td>
                <td>The Converter handles sorted Hibernate 4 (or 3) sets or Envers proxy. It will handle any element of the set.</td>
                <td>Must be registered explicitly in combination with the HibernateMapper and all the other Hibernate converters. See <a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/package-summary.html">package description</a>.</td>
                <td>xstream-hibernate</td>
            </tr>
            <tr>
                <td><a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/converter/HibernateProxyConverter.html">HibernateProxyConverter</a></td>
                <td>org.hibernate.proxy.HibernateProxy</td>
                <td>The Converter handle any element that is wrapped by a Hibernate proxy.</td>
                <td>Must be registered explicitly in combination with the HibernateMapper and all the other Hibernate converters. See <a href="hibernate-javadoc/com/thoughtworks/xstream/hibernate/package-summary.html">package description</a>.</td>
                <td>xstream-hibernate</td>
            </tr>

        </table>

    </body>
</html>